home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 126-150 / disk_146 / memopad / memopad.doc < prev    next >
Text File  |  1992-05-06  |  13KB  |  239 lines
  1.   MemoPad and CheckMemo are products which may be freely distributed 
  2.   on the condition that they are not altered in any way, either by 
  3.   omission or addition to the contents of the ARC file.  The present 
  4.   ARC file for the V1.1 release of MemoPad is exactly 80536 bytes in 
  5.   length.
  6.  
  7.   The author welcomes comments, suggestions for improvement, and any 
  8.   praise you may have for this product.  He may be reached at the 
  9.   following address:
  10.  
  11.                         Michael Griebling    
  12.                       COMPUTER INSPIRATIONS
  13.                     150 Clark Blvd., Suite One
  14.                    Brampton, ON, Canada, L6T 4Y8
  15.                          (416) 792-6797
  16.  
  17.   In order to reward anyone wishing to be registered for a nominal fee 
  18.   of $20, a disk containing the complete Modula-2 source for these 
  19.   programs will be sent out along with a brochure giving details of 
  20.   upcoming products.
  21.  
  22.                    Installing MemoPad & CheckMemo
  23.                    ==============================
  24.  
  25.   I assume that if you are reading this that you have already de-ARCed
  26.   the MemoPad files.  There should be a total of 7 files for this
  27.   program set.  As soon as you invoked this program, all the names
  28.   were auto-magically expanded out, so you won't have to go through the
  29.   usual hassle of EXECUTING the Execute.Me file that is usual in these
  30.   cases.  Why doesn't someone get around to providing an ARC utility
  31.   which will automatically do this if it encounters a longer name?
  32.  
  33.   The CheckMemo utility will check whether any memo items have been
  34.   entered for today's date.  So, in order to do this automatically
  35.   when the AMIGA is powered on, a `CheckMemo' command should be placed
  36.   in your S:Startup-Sequence file, right after any additions or prompts
  37.   which normally set the date.  Next, place the CheckMemo and
  38.   CheckMemo.info files in your C: directory or on one of the paths that
  39.   you add to the command search list.  That's all there is to the 
  40.   installation -- easy wasn't it.  Note: you can also manually check
  41.   the memo items simply by typing `CheckMemo' from CLI or by clicking
  42.   on the CheckMemo icon.  The latter operation may be tricky if both
  43.   CheckMemo and CheckMemo.info are placed in the C: directory, unless
  44.   you keep another copy at the top-level of the WorkBench disk or along
  45.   with the MemoPad.  If nothing happens except a disk access when you
  46.   invoke CheckMemo, don't worry -- it just means that no memo items
  47.   were found for today's date.
  48.  
  49.   The MemoPad utility, which creates the memo items read by CheckMemo,
  50.   may be placed on any convenient working disk which would ordinarily
  51.   be used during your work/play/recreation time with the AMIGA.  Simply
  52.   drag the icon over to your working disk, or from CLI, copy over both
  53.   MemoPad and MemoPad.info to the working disk.
  54.  
  55.  
  56.                           MemoPad Operation
  57.                           =================
  58.  
  59.   MemoPad is a WorkBench utility which runs in a separate window on
  60.   the WorkBench screen.  It is capable of allowing you to generate memo
  61.   items which are simply dated reminders of appointments, birthdays,
  62.   holidays, or any message which can be held on five lines of text.
  63.   When MemoPad is first invoked, it searches the S: device directory 
  64.   for a file called MEMOPAD.DAT.  This file contains all the memo items
  65.   which have been entered by yourself.  Naturally, the first time it is
  66.   invoked, MemoPad won't find this file and will attempt to create one.
  67.   At this time, you may get a message indicating that the WorkBench
  68.   disk is required or that you should unprotect the write tab.  
  69.  
  70.   During start-up, one other file is accessed : MEMOPAD.CUS.  This file
  71.   contains user customization information which allows you to customize
  72.   the MemoPad operation to your individual preferences via the 
  73.   CUSTOMIZE menu selection in MemoPad.  If this file is not found, 
  74.   MemoPad makes some assumptions and gives you a 24-hour clock, a 
  75.   day-month-year date, and a plain MemoPad title.  Naturally, you can 
  76.   customize all these parameters and the next time MemoPad is invoked,
  77.   all your selections will be used.  By the way, the same selections 
  78.   will also be used by CheckMemo.
  79.  
  80.   I felt that everyone would have WorkBench in their drive during 
  81.   startup, so this is where MemoPad normally assumes it will find your
  82.   memo items.  If you don't like these files on your WorkBench disk, 
  83.   then it is possible to reassign the S: device to some other disk. If
  84.   you do this in the Startup-Sequence file, just before invoking 
  85.   CheckMemo, you will be prompted to insert whatever disk was assigned
  86.   to the S: device.  
  87.  
  88.  
  89.                           Other Nifty Things
  90.                           ==================
  91.  
  92.   MemoPad lets you specify repeated memo items which occur fairly 
  93.   regularly on a daily, weekly, monthly, or annual basis for a fixed
  94.   length of time.  To generate such a memo item, first you'll have to
  95.   enable repeats by selecting one of the repeat choices in the REPEAT
  96.   MEMO menu list. By default, repeats will be disabled as is shown by
  97.   the checkmark in front of the "No Repeat" menu item.  Choose one of
  98.   the repeat options and use the NEXT or PREV buttons to get to the
  99.   memo you wish to have repeated.  Click on the DATE button, and use
  100.   the Date Window controls to get to the starting date to be repeated.
  101.   Click on the desired date.  All repeated dates will now also be
  102.   selected.  Use the Date Window controls to check them if you don't
  103.   believe it could be that easy.  Click on the OK button to close the
  104.   Date Window and accept the chosen date; otherwise, just click on
  105.   the QUIT button to keep whatever date was originally on your memo
  106.   item.
  107.  
  108.   The FIND button and the related menu item will let you find one memo
  109.   out of the list of memo items which you have defined.  Click on this
  110.   button, use the Date Window controls to maneuver to the desired date,
  111.   and click on the date to be found.  Click on the OK button and the
  112.   first memo item with this date will be located and displayed.  This
  113.   date search may be cancelled by clicking on the QUIT button.  If the
  114.   date is not found, a message saying this will be displayed in the
  115.   Help Window.  A trick, which may be used to find any memo item in
  116.   a given month might be to select the daily repeat for a month before
  117.   clicking on the Date button.  Any date which is selected will now
  118.   cause a search throughout the entire repeat range for any matching
  119.   memo item dates.
  120.  
  121.   The Help Window is a context sensitive help feature which displays
  122.   help messages as various buttons and/or menu selections are made.
  123.  
  124.   There is never any need to worry whether or not all your memo items
  125.   have been saved to disk!  MemoPad will automatically update the disk
  126.   file, as soon as it notices that some memo item has been changed.
  127.   Even if some other program should cause the AMIGA to crash in a 
  128.   shower of fireworks, you'll be secure in the knowledge that your
  129.   memo items are safe.
  130.  
  131.  
  132.                         About the Modula-2 Source
  133.                         =========================
  134.  
  135.   Probably the first question anyone (especially `C' hackers) would ask
  136.   is: Why use Modula-2?  As a company, Computer Inspirations has a 
  137.   vested interest in the success of its products.  Part of the measure
  138.   of a successful product is the ease with which any product can be
  139.   updated to meet new and anticipated needs of its users.  We feel that
  140.   Modula-2 provides such a vehicle through the use of modern software
  141.   design principles such as object-oriented programming techniques and
  142.   Dave Parnas' information hiding principles.  In addition, Modula-2
  143.   provides a more readable source file which, with the addition of
  144.   suitable comments, can give software maintenance personnel greater
  145.   productivity.  Of course, `C' die-hards would argue, and justifiably
  146.   so, that `C' also provides commenting facilities and does not have
  147.   to be cryptic.  We would agree with this in principle; unfortunately,
  148.   in practice, the same people who thrive on the so-called `concise'
  149.   representation possible using `C' will also shun the use of good
  150.   commenting techniques.  In the final analysis, with the proper
  151.   tools (compiler, debugger, etc.), Modula-2 code can be just as
  152.   compact and fast as `C' code -- without the need for brain-damaging
  153.   syntax.
  154.  
  155.   We, as a company, provide the source code for MemoPad and CheckMemo
  156.   primarily to give interested individuals the tools for programming
  157.   the Amiga using the Intuition-based interface.  Included in the
  158.   source are many examples of gadget-based control, menu initialization
  159.   and use, window creation and manipulation, and requester window use.
  160.   Although bits and pieces of what we do are available in separate
  161.   sources, we feel that having an example which unites all the working
  162.   principles required to produce a full program is beneficial in its
  163.   own right.  As a final note, this program does not show the full
  164.   benefits of the new software design principles since that was not its
  165.   purpose.  We do use comments and structured design principles.  This
  166.   program fails to make full use of the information-hiding metho-
  167.   dologies in some places -- but it is better than a comparable `C'
  168.   program in this respect.  Our primary aim, of course, was to produce
  169.   a program from which others could see how to work within an
  170.   Intuition-based environment; and in this respect, we feel that we
  171.   have succeeded.
  172.   
  173.   
  174.                             Acknowledgements
  175.                             ================
  176.  
  177.   As always, there are a bunch of people behind the scenes who must be
  178.   thanked for their contributions, either direct or indirect, to a 
  179.   program such as this.  Firstly, thanks to TDI for their Modula-2
  180.   compiler, which may not be fastest or the best, but it certainly was
  181.   the first.  Secondly, thanks to all the people who have contributed
  182.   public-domain programs to demonstrate Modula-2 concepts and give 
  183.   others source code examples upon which to build.  In particular,
  184.   thanks to Richie Bielak for his FastTextIO routines, used in this
  185.   previewer.  We also appreciate the artistic talents of Anna-Lise
  186.   Scheel, Colour Consultant, for her work on MemoPad.  Thanks also to
  187.   all the Beta test sites (you know who you are) for their assistance
  188.   and helpful comments.  Thanks also to the people who brought us
  189.   PowerWindows which was used as a starting point for the design of
  190.   windows, gadgets, menus, and requesters used in both MemoPad and
  191.   CheckMemo.  Although, the Modula-2 extensions to this program are
  192.   VERY buggy and have been given inadequate thought, the tool has been
  193.   useful. Finally, thanks to the makers of the Amiga -- without whom
  194.   none of this would have been possible.
  195.  
  196.  
  197.                                Bug Fixes
  198.                                =========
  199.  
  200.   Much as we hate to admit it, a few bugs crept into the V1.0 release
  201.   of MemoPad and CheckMemo.  Thanks to the people who pointed out the
  202.   bugs (people tend to do that).  All known bugs as listed below have
  203.   been exterminated :
  204.  
  205.      Bug 1.0-1  The programs stomped over memory location 00000000
  206.                 while starting up and initializing the Date window.
  207.                 Although this bug didn't usually cause the programs
  208.                 to crash, sometimes, if another program depended on
  209.                 something in memory location 00000000, a crash could
  210.                 occur.  As a matter of fact, if both MemoPad and
  211.                 CheckMemo were running together (yes, they can do
  212.                 that too), closing down one would cause the other
  213.                 one to crash the Amiga.  In our defense, the bug
  214.                 was traced to a pointer to a pointer which the
  215.                 current V3.0a TDI Modula-2 compiler doesn't seem to
  216.                 handle very well.  PowerWindows forced us to use
  217.                 the awkward pointer to a pointer syntax (they must
  218.                 be `C' programmers!), hence our memory stomping.
  219.  
  220.      Bug 1.0-2  To our shock, we discovered that the DOS date was 
  221.                 in error by one day (at least during this leap year).
  222.                 It worked fine last year. ;-)
  223.                 A new algorithm is now being used.
  224.  
  225.                 
  226.                         About Computer Inspirations
  227.                         ===========================
  228.  
  229.   Although COMPUTER INSPIRATIONS is fairly new to the AMIGA and other 
  230.   personal computers, we have gained considerable experience in 
  231.   software and hardware development from work in the aerospace industry
  232.   and from a university environment.  We are committed to bringing 
  233.   quality products to AMIGA owners at affordable prices.  We will make
  234.   certain that all our products reflect this attention to detail and
  235.   we will respond promptly to any customer problems or concerns.
  236.  
  237.   Michael Griebling,
  238.   President, COMPUTER INSPIRATIONS
  239.